home *** CD-ROM | disk | FTP | other *** search
/ Eagles Nest BBS 1 / Eagles_Nest_Mac_Collection_Disc_1.TOAST / Networking / Mac⁄Net22 / Docs / New BM Docs < prev    next >
Text File  |  1991-04-21  |  4KB  |  101 lines
  1.                                                             BM User Manual
  2.  
  3.                                                           Dave Trulli, NN2Z
  4.  
  5. Table of Contents
  6.  
  7. 1.    What is BM ?    1
  8. 2.    BM Installation    1
  9. 2.1    Directory Structure    1
  10. 2.2    Configuration Files    1
  11. 2.2.1    The :bm.rc file    1
  12. 2.3.1    The :alias file    3
  13. 2.3.2    :spool:mqeue:sequence.seq    4
  14. 3.    Commands    4
  15.  
  16. 1.    What is BM ?
  17.  
  18. BM is designed to serve as the mail user-interface for the KA9Q TCP/IP inter-networking package.  It provides a full set of mail services to the user which allows the sending and receipt of electronic mail.
  19.  
  20.  
  21. 2.    BM Installation
  22.  
  23. To install BM requires the modification of the supplied configuration files and the creation of the proper directory structure.  The following sections describe the file and directory structure used by BM and SMTP.
  24.  
  25.  
  26. 2.1    Directory Structure
  27.  
  28. :spool:mqueue    This directory holds the outbound mail jobs for SMTP.  Each job consists of 2 files a xxxx.txt and xxxx.wrk file where xxxx is a unique numerical prefix.  The format of the files are described in a later section.
  29.  
  30. :spool:rqueue    This directory is used by SMTP for jobs that have been received and will be processed by a user defined mail routing program.  This directory is not used directly by BM.
  31.  
  32. :spool:mail    This directory holds the individual mailboxes for each user name on your system.  The extension .txt is added to the user name to form the mailbox name.  Mail received by the SMTP server is appended to the mailbox file.
  33.  
  34.  
  35. 2.2    Configuration Files
  36.  
  37.  
  38. 2.2.1    The bm.rc file;.  The bm.rc file provides BM with the configuration needed for the operation of the mailer.
  39.  
  40. The format for the bm.rc file is:
  41.  
  42. variable <space> value <cr>
  43.  
  44. The following variables are valid in the bm.rc file:
  45.  
  46. smtp <mail path>
  47.  
  48. defines the path to the directory containing the mailbox files.  The default directory is :spool:mail on the current drive.
  49.  
  50. host <your host name >
  51.  
  52. Is used to set the local hostname for use in the RFC822 mail headers.  This is a required field.
  53.  
  54. user <user name>
  55.  
  56. Defines the user name of the person who is sending mail.  This is also used as the default mailbox for reading mail.  On the AMPRNET this is usually set to your call.  There is a DOS limit of 8 characters for the user name.
  57.  
  58. fullname <your full name>
  59.  
  60. Is used to provide your full name to the mailer for use in the comment portion of "From:" header line.  The use of fullname is optional.
  61.  
  62. reply <return address>
  63.  
  64. Defines the address where you wish to receive replies to messages sent.  This option is useful if you are operating your pc on a local area network and would like your mail replies sent to a more "well known host".  The address specified by reply is used to generate a "Reply-To:" header in outbound mail.  The "Reply-To:" header overrides the "From:" header which is the address normally used to reply to mail.  This field is optional.
  65.  
  66.  
  67. host nn2z.ampr
  68. user nn2z
  69. fullname Dave Trulli
  70. # send my replies to the Sun
  71. reply nn2z@ka9q.bellcore.com
  72.  
  73.  
  74.  
  75. 2.3.1    The alias file; The alias file provides an easy way to maintain mailing lists.  An alias can be any string of characters not containing the "@" symbol.  The format for the alias file is:
  76.  
  77. alias   recip1 recip2 recip3....<cr>
  78. <tab>   recip4
  79.  
  80. Note that a long list of aliases can be continued on an additional line by placing a tab or space on the continuation line.
  81.  
  82. Some examples aliases are:
  83.  
  84. dave  nn2z@nn2z.ampr
  85.  
  86. phil  karn@ka9q.bellcore.com
  87.  
  88. # mail to local nnj users
  89. nnj  wb2cop@wb2cop.ampr karn@ka9q.bellcore.com
  90.   wb0mpq@home.wb0mpq.ampr w2kb@w2kb.ampr ka2tsm@ka2tsm.ampr
  91.  
  92. In the above example, when specifying nnj as the recipient, BM will expand the alias into the list of recipients from the alias file.  At this time an alias may not contain any other aliases.
  93.  
  94.  
  95. 2.3.2    :spool:mqeue:sequence.seq;  The sequence file maintains a message counter which is used by BM and SMTP to generate message id's and unique filenames.  This file is created by BM.
  96.  
  97.  
  98. 3.    Commands
  99.  
  100. This section has not be written in time for this distribution.   Please refer to the Help command under the Apple Menu for use of the new BMailer for the Macintosh.
  101.